home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 1 / Amiga Tools.iso / egs-tools / egs_dev-disk / egsdocs / egsintui.doc < prev    next >
Encoding:
Text File  |  1994-06-06  |  42.3 KB  |  2,009 lines
  1. TABLE OF CONTENTS
  2.  
  3. egsintui.library/EI_ActivateGadget
  4. egsintui.library/EI_ActivateWindow
  5. egsintui.library/EI_AddGList
  6. egsintui.library/EI_AddGadget
  7. egsintui.library/EI_AddToItem
  8. egsintui.library/EI_AddToMenu
  9. egsintui.library/EI_BeginRefresh
  10. egsintui.library/EI_ClearPointer
  11. egsintui.library/EI_CloneColor
  12. egsintui.library/EI_CloseScreen
  13. egsintui.library/EI_CloseWindow
  14. egsintui.library/EI_CreateItem
  15. egsintui.library/EI_CreateLeave
  16. egsintui.library/EI_CreateMenu
  17. egsintui.library/EI_DeactivateGadget
  18. egsintui.library/EI_DeactivateWindow
  19. egsintui.library/EI_DoubleClick
  20. egsintui.library/EI_DragNDropClip
  21. egsintui.library/EI_DragNDropData
  22. egsintui.library/EI_DragNDropFile
  23. egsintui.library/EI_DragNDropFiles
  24. egsintui.library/EI_EndRefresh
  25. egsintui.library/EI_FindMenuItem
  26. egsintui.library/EI_FindSubMenu
  27. egsintui.library/EI_FreeMenu
  28. egsintui.library/EI_GetDefaultColor
  29. egsintui.library/EI_GetDefaultScreen
  30. egsintui.library/EI_GetPrefFont
  31. egsintui.library/EI_GetPrefPointer
  32. egsintui.library/EI_GetPrefsColor
  33. egsintui.library/EI_GetWinColor
  34. egsintui.library/EI_Interpret
  35. egsintui.library/EI_Interpret1Param
  36. egsintui.library/EI_Interpret2Param
  37. egsintui.library/EI_InterpretStacked
  38. egsintui.library/EI_LockIntuition
  39. egsintui.library/EI_MigrateWindow
  40. egsintui.library/EI_ModifyIDCMP
  41. egsintui.library/EI_MoveWindow
  42. egsintui.library/EI_ObtainColor
  43. egsintui.library/EI_OffGList
  44. egsintui.library/EI_OffGadget
  45. egsintui.library/EI_OffMenuItem
  46. egsintui.library/EI_OnGList
  47. egsintui.library/EI_OnGadget
  48. egsintui.library/EI_OnMenuItem
  49. egsintui.library/EI_OpenScreen
  50. egsintui.library/EI_OpenWindow
  51. egsintui.library/EI_PutMenuHome
  52. egsintui.library/EI_PutMenuOut
  53. egsintui.library/EI_RedrawGadgetList
  54. egsintui.library/EI_RefreshGList
  55. egsintui.library/EI_RefreshGadget
  56. egsintui.library/EI_RefreshScreen
  57. egsintui.library/EI_RefreshWindow
  58. egsintui.library/EI_ReleaseColor
  59. egsintui.library/EI_RemoveGList
  60. egsintui.library/EI_RemoveGadget
  61. egsintui.library/EI_ReportMouse
  62. egsintui.library/EI_ScrollWindow
  63. egsintui.library/EI_SetMenuStrip
  64. egsintui.library/EI_SetMouseMoveIntervall
  65. egsintui.library/EI_SetPointer
  66. egsintui.library/EI_SetWindowTitles
  67. egsintui.library/EI_SizeWindow
  68. egsintui.library/EI_SleepWindow
  69. egsintui.library/EI_SysRequest
  70. egsintui.library/EI_ToggleMenuItem
  71. egsintui.library/EI_UnlockIntuition
  72. egsintui.library/EI_WakeWindow
  73. egsintui.library/EI_WindowBorder
  74. egsintui.library/EI_WindowToBack
  75. egsintui.library/EI_WindowToFront
  76.  
  77. egsintui.library/EI_ActivateGadget         egsintui.library/EI_ActivateGadget
  78.  
  79.    NAME
  80.     EI_ActivateGadget -- activate a string gadget
  81.  
  82.    SYNOPSIS
  83.     EI_ActivateGadget(win, gad, force)
  84.                       A0   A1   D0
  85.  
  86.     void EI_ActivateGadget(EI_WindowPtr, EI_GadgetPtr, ULONG)
  87.  
  88.    FUNCTION
  89.     Attempts to activate a string gadget. If force is false this will
  90.     only succeed if the gadgets window is active and no other string
  91.     gadget is active. If force is true this call will allways succeed, by
  92.     deactivating other gadgets and activating the gadgets window.
  93.  
  94.    INPUTS
  95.     win   : gadgets window
  96.     gad   : pointer to the gadget
  97.     force : true, to force activation
  98.  
  99.    RESULT
  100.  
  101.    SEE ALSO
  102.  
  103.  
  104. egsintui.library/EI_ActivateWindow         egsintui.library/EI_ActivateWindow
  105.  
  106.    NAME
  107.     EI_ActivateWindow -- activate window
  108.  
  109.    SYNOPSIS
  110.     EI_ActivateWindow(win)
  111.                       A0
  112.  
  113.     void EI_ActivateWindow(EI_WindowPtr)
  114.  
  115.    FUNCTION
  116.     Activates a window, the actual active window will become
  117.     deactivated.
  118.  
  119.    INPUTS
  120.     win   : pointer to window
  121.  
  122.    RESULT
  123.  
  124.    SEE ALSO
  125.  
  126.  
  127. egsintui.library/EI_AddGList                     egsintui.library/EI_AddGList
  128.  
  129.    NAME
  130.     EI_AddGList -- add several gadgets
  131.  
  132.    SYNOPSIS
  133.     EI_AddGList(win, gad, num)
  134.                 A0   A1   D0
  135.  
  136.     void EI_AddGList(EI_WindowPtr, EI_GadgetPtr, WORD)
  137.  
  138.    FUNCTION
  139.     Adds a list of gadgets to a windows gadget list, and displays them.
  140.     If there are master gadgets in the list, all son gadgets will be
  141.     added too.
  142.  
  143.    INPUTS
  144.     win    : pointer to window
  145.     gad    : pointer to first gadget in list
  146.     num    : number of gadgets in list
  147.  
  148.    RESULT
  149.  
  150.    SEE ALSO
  151.  
  152.  
  153. egsintui.library/EI_AddGadget                   egsintui.library/EI_AddGadget
  154.  
  155.    NAME
  156.     EI_AddGadget -- add gadget to window
  157.  
  158.    SYNOPSIS
  159.     EI_AddGadget(win, gad)
  160.                  A0   A1
  161.  
  162.     void EI_AddGadget(EI_WindowPtr, EI_GadgetPtr)
  163.  
  164.    FUNCTION
  165.     Adds a gadget to the windows gadget list and displays it. If this is
  166.     a master gadget all asociated son gadgets are also added. If the
  167.     gadget is not disabled using gadget flag EI_gadgetInactive, the user
  168.     can reach it immediately.
  169.  
  170.    INPUTS
  171.     win    : window to which to add
  172.     gad    : pointer to gadget
  173.  
  174.    RESULT
  175.  
  176.    SEE ALSO
  177.  
  178.  
  179. egsintui.library/EI_AddToItem                   egsintui.library/EI_AddToItem
  180.  
  181.    NAME
  182.     EI_AddToItem -- add a sub menu item to an item
  183.  
  184.    SYNOPSIS
  185.     EI_AddToItem(item, add)
  186.                  A0    A1
  187.  
  188.     void EI_AddToItem(EI_MenuItemPtr, EI_MenuItemPtr)
  189.  
  190.    FUNCTION
  191.     Adds an item 'add' (or an submenu leaf) to an item 'item'. If the
  192.     item has none submenu attached yet, this routine creates one. Make
  193.     sure that the subitem 'add' is full bulidt up, when you add it to the
  194.     submenu, because several initialisations are done to 'add' during
  195.     this routine.
  196.  
  197.    INPUTS
  198.     item    : The item to become an item with a sub menu
  199.     add     : The item to be included in the sub menu
  200.  
  201.    RESULT
  202.  
  203.    SEE ALSO
  204.  
  205.  
  206. egsintui.library/EI_AddToMenu                   egsintui.library/EI_AddToMenu
  207.  
  208.    NAME
  209.     EI_AddToMenu -- add a menu item to an main menu
  210.  
  211.    SYNOPSIS
  212.     EI_AddToMenu(menu, add)
  213.                  A0    A1
  214.  
  215.     void EI_AddToMenu(EI_MenuPtr, EI_MenuItemPtr)
  216.  
  217.    FUNCTION
  218.     Adds an item 'add' (or an submenu leaf) to a menu. Make sure that
  219.     the item 'add' is full buildt up, when you add it to the root menu,
  220.     because several initialisations are done to 'add' during this
  221.     routine.
  222.  
  223.    INPUTS
  224.     menu    : The menu to be extended
  225.     add     : The item to be included in the root menu
  226.  
  227.    RESULT
  228.  
  229.    SEE ALSO
  230.  
  231.  
  232. egsintui.library/EI_BeginRefresh             egsintui.library/EI_BeginRefresh
  233.  
  234.    NAME
  235.     EI_BeginRefresh -- begin refresh for window
  236.  
  237.    SYNOPSIS
  238.     EI_BeginRefresh(win, key)
  239.                     A0   D0
  240.  
  241.     ULONG EI_BeginRefresh(EI_WindowPtr, LONG)
  242.  
  243.    FUNCTION
  244.     Attempts to start a refresh for a window. For more information look
  245.     at egslayers.library/EL_BeginUpdate.
  246.  
  247.     The border, the gadgets and the rendering of the intuigfx programm
  248.     in the window field .render, is carried out automagically by the
  249.     egsintui.library.
  250.  
  251.    INPUTS
  252.     key    : refresh key
  253.  
  254.    RESULT
  255.  
  256.    SEE ALSO
  257.  
  258.  
  259. egsintui.library/EI_ClearPointer             egsintui.library/EI_ClearPointer
  260.  
  261.    NAME
  262.     EI_ClearPointer -- remove windows pointer
  263.  
  264.    SYNOPSIS
  265.     EI_ClearPointer(win)
  266.                     A0
  267.  
  268.     void EI_ClearPointer(EI_WindowPtr)
  269.  
  270.    FUNCTION
  271.     Removes the windows pointer and uses the default pointer again.
  272.  
  273.    INPUTS
  274.     win          -
  275.  
  276.    RESULT
  277.  
  278.    SEE ALSO
  279.  
  280.  
  281. egsintui.library/EI_CloneColor                 egsintui.library/EI_CloneColor
  282.  
  283.    NAME
  284.     EI_CloneColor -- clone a screen color
  285.  
  286.    SYNOPSIS
  287.     EI_CloneColor(scr, color)
  288.                   A0   D0
  289.  
  290.     ULONG EI_CloneColor(EI_ScreenPtr, ULONG)
  291.  
  292.    FUNCTION
  293.     Clones the lock on an allready locked screen color. The resulting
  294.     color has to be released, when not needed any more.
  295.  
  296.    INPUTS
  297.     scr          -
  298.     color        -
  299.  
  300.    RESULT
  301.  
  302.    SEE ALSO
  303.  
  304.  
  305. egsintui.library/EI_CloseScreen               egsintui.library/EI_CloseScreen
  306.  
  307.    NAME
  308.     EI_CloseScreen -- close a screen
  309.  
  310.    SYNOPSIS
  311.     EI_CloseScreen(scr)
  312.                    A0
  313.  
  314.     void EI_CloseScreen(EI_ScreenPtr)
  315.  
  316.    FUNCTION
  317.     Closes a screen that was opened using EI_OpenScreen, and all windows
  318.     which reside on it. All memory and structures that are linked to this
  319.     screen E_Screen, EL_LayerInfo etc. are freed.
  320.  
  321.    INPUTS
  322.     scr          -
  323.  
  324.    RESULT
  325.  
  326.    SEE ALSO
  327.  
  328.  
  329. egsintui.library/EI_CloseWindow               egsintui.library/EI_CloseWindow
  330.  
  331.    NAME
  332.     EI_CloseWindow -- close a window
  333.  
  334.    SYNOPSIS
  335.     EI_CloseWindow(win)
  336.                    A0
  337.  
  338.     void EI_CloseWindow(EI_WindowPtr)
  339.  
  340.    FUNCTION
  341.     Closes a window, opened by EI_OpenWindow, frees all linked
  342.     structures like layer, rastport etc. If it was the last window on the
  343.     default screen, the default screen is also closed.
  344.  
  345.    INPUTS
  346.     win          -
  347.  
  348.    RESULT
  349.  
  350.    SEE ALSO
  351.  
  352.  
  353. egsintui.library/EI_CreateItem                 egsintui.library/EI_CreateItem
  354.  
  355.    NAME
  356.     EI_CreateItem -- create a menu item
  357.  
  358.    SYNOPSIS
  359.     EI_CreateItem(font, name, id, key, toggle)
  360.                   A0    A1    D0  D1   D2
  361.  
  362.     EI_MenuItemPtr EI_CreateItem(EG_EFontPtr, char *, LONG, char, LONG)
  363.  
  364.    FUNCTION
  365.     Creates an menu item to be attached to a menu or sub menu by
  366.     EI_AddToMenu or EI_AddToItem. The font 'font' has to be kept open, as
  367.     long as the menu is being used. If char is no null byte, the item has
  368.     a hot key. If toggle is TRUE then the item has a check mark, and can
  369.     be toggeled.
  370.  
  371.    INPUTS
  372.     font    : The font to be used for the item. The suggestion for the font
  373.         is the screen font if you attache the menu to screen else the
  374.         windows font.
  375.     name    : The name of the item.
  376.     id      : The id to be used and to identify the item.
  377.     key     : A shortcut character or a NULL for no shortcut
  378.     toggle  : A flag, determinig if the item is toggleable
  379.  
  380.    RESULT
  381.     item - the created menu-item or NULL for failure
  382.  
  383.    EXAMPLE
  384.     /*
  385.     ** Author: Markus van Kempen
  386.     ** Date  : 17. Dezember 1992
  387.     **
  388.     ** Input : EG_EFontPtr = Point to a Font for Menu
  389.     ** Output: EI_MenuPtr  = Point to the Menu-Structure
  390.     **                       for assign to the EI_NewWindow-Structure
  391.     **                       --> "newWindow.menu=menu"
  392.     **
  393.     ** This is a routine for init a menu structure.
  394.     ** It calls the functions from egsintui.library.
  395.     ** If you want to change the menus, you must
  396.     ** only change this file.
  397.     **
  398.     **
  399.     ** (c) by VIONA-Development 1992/93
  400.     **
  401.     */
  402.  
  403.     EI_MenuPtr        EI_CreateMenu(void);
  404.     EI_MenuItemPtr    EI_CreateLeave(void);
  405.  
  406.     EI_MenuPtr InitMenu(EG_EFontPtr font)
  407.     {
  408.  
  409.     EI_MenuPtr      menu;
  410.     EI_MenuItemPtr  item1,item2;
  411.     struct TextAttr *attr;
  412.  
  413.     if(font == NULL)
  414.     {
  415.     attr = (struct TextAttr *) EI_GetPrefFont(1);
  416.     font = (EG_EFontPtr)       EG_OpenFont(attr);
  417.  
  418.     }
  419.  
  420.  
  421.     /** Create a complex menu, which will look like this
  422.  
  423.     +----------------------------+------------+
  424.     | Project                    | Flags      |
  425.     +------------+---------------+-----------++
  426.     +------------+               +-----------+
  427.     | Load     O |               | -/ Flag 1 |
  428.     |  Save... > +--------------+| -/ Flag 2 |
  429.     | Rename     | Save       S ||    Flag 3 |
  430.     | New      N | Save as    A ||    Flag 4 |
  431.     | Close    X | Save & Close ||    Flag 5 |
  432.     | About      +--------------+|    Flag 6 |
  433.     | Quit     Q |               |    Flag 7 |
  434.     +------------+               +-----------+
  435.  
  436.     **/
  437.  
  438.     menu  = EI_CreateMenu();
  439.     item1 = EI_CreateItem(font,"Project",0,0,0);
  440.     EI_AddToItem(item1,EI_CreateLeave());
  441.     EI_AddToItem(item1,EI_CreateItem(font,"Load", 0x1,'O',0));
  442.     item2=EI_CreateItem(font,"Save",0x10,0,0);
  443.     EI_AddToItem(item2,EI_CreateItem(font,"Save"         ,0x11,'S',0));
  444.     EI_AddToItem(item2,EI_CreateItem(font,"Save as"      ,0x12,'A',0));
  445.     EI_AddToItem(item2,EI_CreateItem(font,"Save & Close" ,0x13,'C',0));
  446.     EI_AddToItem(item1,item2);
  447.     EI_AddToItem(item1,EI_CreateItem(font,"New",  0x3,'N',0));
  448.     EI_AddToItem(item1,EI_CreateItem(font,"Close",0x4,'X',0));
  449.     EI_AddToItem(item1,EI_CreateItem(font,"About",0x5,NULL,0));
  450.     EI_AddToItem(item1,EI_CreateItem(font,"Quit" ,0x6,'Q',0));
  451.     EI_AddToMenu(menu,item1);
  452.     item1 = EI_CreateItem(font,"Flags",0,0,0);
  453.     EI_AddToItem(item1,EI_CreateLeave());
  454.     EI_AddToItem(item1,EI_CreateItem(font,"Flag 1",0x20,0,1));
  455.     EI_AddToItem(item1,EI_CreateItem(font,"Flag 2",0x21,0,1));
  456.     EI_AddToItem(item1,EI_CreateItem(font,"Flag 3",0x22,0,1));
  457.     EI_AddToItem(item1,EI_CreateItem(font,"Flag 4",0x23,0,1));
  458.     EI_AddToItem(item1,EI_CreateItem(font,"Flag 5",0x24,0,1));
  459.     EI_AddToItem(item1,EI_CreateItem(font,"Flag 6",0x25,0,1));
  460.     EI_AddToItem(item1,EI_CreateItem(font,"Flag 7",0x26,0,1));
  461.     EI_AddToMenu(menu,item1);
  462.     return(menu);
  463.     }
  464.  
  465.    SEE ALSO
  466.  
  467.  
  468. egsintui.library/EI_CreateLeave               egsintui.library/EI_CreateLeave
  469.  
  470.    NAME
  471.     EI_CreateLeave -- create an item to detach a submenu
  472.  
  473.    SYNOPSIS
  474.     EI_CreateLeave()
  475.  
  476.  
  477.     EI_MenuItemPtr EI_CreateLeave(void)
  478.  
  479.    FUNCTION
  480.     Creates a menu item that gives the user the ability to detach a
  481.     submenu from its item. You must add this item to the sub menu using
  482.     EI_AddToItem.
  483.  
  484.    INPUTS
  485.  
  486.    RESULT
  487.     item : Detach menu item
  488.  
  489.    SEE ALSO
  490.  
  491.  
  492. egsintui.library/EI_CreateMenu                 egsintui.library/EI_CreateMenu
  493.  
  494.    NAME
  495.     EI_CreateMenu -- creates a root menue
  496.  
  497.    SYNOPSIS
  498.     EI_CreateMenu()
  499.  
  500.  
  501.     EI_MenuPtr EI_CreateMenu(void)
  502.  
  503.    FUNCTION
  504.     Creates a root menu. Items can be attached to this menu using
  505.     EI_AddToMenu. See EI_CreateItem for more informations.
  506.  
  507.    INPUTS
  508.  
  509.    RESULT
  510.     menu : An empty root menu structure.
  511.  
  512.    SEE ALSO
  513.  
  514.  
  515. egsintui.library/EI_DeactivateGadget     egsintui.library/EI_DeactivateGadget
  516.  
  517.    NAME
  518.     EI_DeactivateGadget --
  519.  
  520.    SYNOPSIS
  521.     EI_DeactivateGadget()
  522.  
  523.  
  524.     void EI_DeactivateGadget(void)
  525.  
  526.    FUNCTION
  527.         is internal used !
  528.    INPUTS
  529.  
  530.    RESULT
  531.  
  532.    SEE ALSO
  533.  
  534.  
  535. egsintui.library/EI_DeactivateWindow     egsintui.library/EI_DeactivateWindow
  536.  
  537.    NAME
  538.     EI_DeactivateWindow -- deactivate window
  539.  
  540.    SYNOPSIS
  541.     EI_DeactivateWindow(win)
  542.                         A0
  543.  
  544.     void EI_DeactivateWindow(EI_WindowPtr)
  545.  
  546.    FUNCTION
  547.     Deactivates a window, if it was currently the active one. The window
  548.     that was active before this window, will become active again.
  549.  
  550.    INPUTS
  551.     win          -
  552.  
  553.    RESULT
  554.  
  555.    SEE ALSO
  556.  
  557.  
  558. egsintui.library/EI_DoubleClick               egsintui.library/EI_DoubleClick
  559.  
  560.    NAME
  561.     EI_DoubleClick -- check for double click
  562.  
  563.    SYNOPSIS
  564.     EI_DoubleClick(StartSec, StartMicros, EndSec, EndMicros)
  565.                    D0        D1           D2      D3
  566.  
  567.     ULONG EI_DoubleClick(LONG, LONG, LONG, LONG)
  568.  
  569.    FUNCTION
  570.     Checks if two mouse clicks are one double click, by checking if the
  571.     time between the ticks is small enough (actually calls
  572.     intuition.library/DoubleClick).
  573.  
  574.    INPUTS
  575.     StartSec     -
  576.     StartMicros  -
  577.     EndSec       -
  578.     EndMicros    -
  579.  
  580.    RESULT
  581.  
  582.    SEE ALSO
  583.  
  584.  
  585. egsintui.library/EI_DragNDropClip           egsintui.library/EI_DragNDropClip
  586.  
  587.    NAME
  588.     EI_DragNDropClip --
  589.  
  590.    SYNOPSIS
  591.     EI_DragNDropClip(draw, ox, oy, w, h, from, type, clipID)
  592.                      A0    D0  D1  D2 D3 A1    D4    D5
  593.  
  594.     void EI_DragNDropClip(IG_IntuiGfxPtr, int, int, int, int, EI_WindowPtr, LONG, LONG)
  595.  
  596.    FUNCTION
  597.  
  598.    INPUTS
  599.     draw         -
  600.     ox           -
  601.     oy           -
  602.     w            -
  603.     h            -
  604.     from         -
  605.     type         -
  606.     clipID       -
  607.  
  608.    RESULT
  609.  
  610.    SEE ALSO
  611.  
  612.  
  613. egsintui.library/EI_DragNDropData           egsintui.library/EI_DragNDropData
  614.  
  615.    NAME
  616.     EI_DragNDropData --
  617.  
  618.    SYNOPSIS
  619.     EI_DragNDropData(draw, ox, oy, w, h, from, type, data, size)
  620.                      A0    D0  D1  D2 D3 A1    D4    A2    D5
  621.  
  622.     void EI_DragNDropData(IG_IntuiGfxPtr, int, int, int, int, EI_WindowPtr, LONG, APTR, LONG)
  623.  
  624.    FUNCTION
  625.  
  626.    INPUTS
  627.     draw         -
  628.     ox           -
  629.     oy           -
  630.     w            -
  631.     h            -
  632.     from         -
  633.     type         -
  634.     data         -
  635.     size         -
  636.  
  637.    RESULT
  638.  
  639.    SEE ALSO
  640.  
  641.  
  642. egsintui.library/EI_DragNDropFile           egsintui.library/EI_DragNDropFile
  643.  
  644.    NAME
  645.     EI_DragNDropFile --
  646.  
  647.    SYNOPSIS
  648.     EI_DragNDropFile(draw, ox, oy, w, h, from, type, file)
  649.                      A0    D0  D1  D2 D3 A1    D4    A2
  650.  
  651.     void EI_DragNDropFile(IG_IntuiGfxPtr, int, int, int, int, EI_WindowPtr, LONG, char *)
  652.  
  653.    FUNCTION
  654.  
  655.    INPUTS
  656.     draw         -
  657.     ox           -
  658.     oy           -
  659.     w            -
  660.     h            -
  661.     from         -
  662.     type         -
  663.     file         -
  664.  
  665.    RESULT
  666.  
  667.    SEE ALSO
  668.  
  669.  
  670. egsintui.library/EI_DragNDropFiles         egsintui.library/EI_DragNDropFiles
  671.  
  672.    NAME
  673.     EI_DragNDropFiles --
  674.  
  675.    SYNOPSIS
  676.     EI_DragNDropFiles(draw, ox, oy, w, h, from, type, files)
  677.                       A0    D0  D1  D2 D3 A1    D4    A2
  678.  
  679.     void EI_DragNDropFiles(IG_IntuiGfxPtr, int, int, int, int, EI_WindowPtr, LONG, char *)
  680.  
  681.    FUNCTION
  682.  
  683.    INPUTS
  684.     draw         -
  685.     ox           -
  686.     oy           -
  687.     w            -
  688.     h            -
  689.     from         -
  690.     type         -
  691.     files        -
  692.  
  693.    RESULT
  694.  
  695.    SEE ALSO
  696.  
  697.  
  698. egsintui.library/EI_EndRefresh                 egsintui.library/EI_EndRefresh
  699.  
  700.    NAME
  701.     EI_EndRefresh --
  702.  
  703.    SYNOPSIS
  704.     EI_EndRefresh(win, ready)
  705.                   A0   D0
  706.  
  707.     void EI_EndRefresh(EI_WindowPtr, ULONG)
  708.  
  709.    FUNCTION
  710.     Ends a refresh segment. Look at egslayers.library/EndUpdate for more
  711.     information.
  712.  
  713.    INPUTS
  714.     win          -
  715.     ready        -
  716.  
  717.    RESULT
  718.  
  719.    SEE ALSO
  720.  
  721.  
  722. egsintui.library/EI_FindMenuItem             egsintui.library/EI_FindMenuItem
  723.  
  724.    NAME
  725.     EI_FindMenuItem --
  726.  
  727.    SYNOPSIS
  728.     EI_FindMenuItem(menu, id)
  729.                     A0    D0
  730.  
  731.     EI_MenuItemPtr EI_FindMenuItem(EI_MenuPtr, LONG)
  732.  
  733.    FUNCTION
  734.     Searches recursively for a menu item in the described menu. Returns
  735.     NULL, it no item is found.
  736.  
  737.    INPUTS
  738.     menu   : the root menu
  739.     id     : the id of the searched menu item
  740.  
  741.    RESULT
  742.     item   : a pointer to the item or NULL
  743.  
  744.    SEE ALSO
  745.  
  746.  
  747. egsintui.library/EI_FindSubMenu               egsintui.library/EI_FindSubMenu
  748.  
  749.    NAME
  750.     EI_FindSubMenu --
  751.  
  752.    SYNOPSIS
  753.     EI_FindSubMenu(menu, id)
  754.                    A0    D0
  755.  
  756.     EI_MenuPtr EI_FindSubMenu(EI_MenuPtr, LONG)
  757.  
  758.    FUNCTION
  759.     Searches recursively for a menu item in the described menu. Returns
  760.     NULL, it no item is found, or the sub menu that contains the item.
  761.  
  762.    INPUTS
  763.     menu    : the root menu
  764.     id      : the id of the searched menu item
  765.  
  766.    RESULT
  767.     submenu : a pointer to the sub menu that contains the item
  768.  
  769.    SEE ALSO
  770.  
  771.  
  772. egsintui.library/EI_FreeMenu                     egsintui.library/EI_FreeMenu
  773.  
  774.    NAME
  775.     EI_FreeMenu -- free the memory associated to a menue
  776.  
  777.    SYNOPSIS
  778.     EI_FreeMenu(menu)
  779.                 A0
  780.  
  781.     void EI_FreeMenu(EI_MenuPtr)
  782.  
  783.    FUNCTION
  784.     Returns the memory that was allocated for a menu, using
  785.     EI_CreateMenu and EI_CreateItem back to the free memory pool. This is
  786.     done recursively for all submenues and items. So you need only one
  787.     call to clean up a menu and all its submenues and items. Make sure
  788.     that you only free items and menus that have been allocated using
  789.     EI_CreateMenu, EI_CreateItem and EI_CreateLeave.
  790.  
  791.    INPUTS
  792.     menu   : Menustructure that has been allocated by EI_CreateMenu etc.
  793.  
  794.    RESULT
  795.  
  796.    SEE ALSO
  797.  
  798.  
  799. egsintui.library/EI_GetDefaultColor       egsintui.library/EI_GetDefaultColor
  800.  
  801.    NAME
  802.     EI_GetDefaultColor -- get a default color
  803.  
  804.    SYNOPSIS
  805.     EI_GetDefaultColor(depth, tag)
  806.                        D0     D1
  807.  
  808.     ULONG EI_GetDefaultColor(WORD, ULONG)
  809.  
  810.    FUNCTION
  811.     Returns the preference value of a screen color.
  812.  
  813.    INPUTS
  814.     tag must be a element of the colortags (EIC_...) defined in egsintui.h
  815.  
  816.    RESULT
  817.  
  818.    SEE ALSO
  819.  
  820.  
  821. egsintui.library/EI_GetDefaultScreen     egsintui.library/EI_GetDefaultScreen
  822.  
  823.    NAME
  824.     EI_GetDefaultScreen -- return a pointer to the default NewScreen
  825.  
  826.    SYNOPSIS
  827.     EI_GetDefaultScreen()
  828.  
  829.  
  830.     struct EI_NewScreen * EI_GetDefaultScreen(void)
  831.  
  832.    FUNCTION
  833.     Returns a pointer to the "NewScreen" structure of the default
  834.     screen. You might use this function to clone the default screen. If
  835.     you need some information of the default screen before you open a
  836.     window on it, it is suggested to open an offscreen window, and
  837.     retrieve the information there.
  838.  
  839.    INPUTS
  840.  
  841.    RESULT
  842.  
  843.    SEE ALSO
  844.  
  845.  
  846. egsintui.library/EI_GetPrefFont               egsintui.library/EI_GetPrefFont
  847.  
  848.    NAME
  849.     EI_GetPrefFont -- get one of the preferences fonts
  850.  
  851.    SYNOPSIS
  852.     EI_GetPrefFont(type)
  853.                    D0
  854.  
  855.     struct TextAttr * EI_GetPrefFont(ULONG)
  856.  
  857.    FUNCTION
  858.     Returns a text attr structure for one of the default fonts. These
  859.     fonts are the user selected and should be used whenever possible.
  860.  
  861.    INPUTS
  862.     type    : 0 -> Screenfont
  863.         1 -> Windowfont
  864.         2 -> Systemfont
  865.  
  866.    RESULT
  867.     font    : the selected font, or NULL if not supported
  868.  
  869.    SEE ALSO
  870.  
  871.  
  872. egsintui.library/EI_GetPrefPointer         egsintui.library/EI_GetPrefPointer
  873.  
  874.    NAME
  875.     EI_GetPrefPointer -- get one of the preferences pointers
  876.  
  877.    SYNOPSIS
  878.     EI_GetPrefPointer(tag)
  879.                       D0
  880.  
  881.     E_EMousePtr EI_GetPrefPointer(ULONG)
  882.  
  883.    FUNCTION
  884.     Returns an egs mouse structure, that may be passed to 'SetPointer'.
  885.     Valid values for type are defined in egsintui.h with prefix 'EIM_'.
  886.  
  887.    INPUTS
  888.     type   : Mousetypes (EIM_...)
  889.  
  890.    RESULT
  891.     mouse  : the selected mouse (this is no copy, but the original and may not
  892.        be altered).
  893.  
  894.    SEE ALSO
  895.  
  896.  
  897. egsintui.library/EI_GetPrefsColor           egsintui.library/EI_GetPrefsColor
  898.  
  899.    NAME
  900.     EI_GetPrefsColor --
  901.  
  902.    SYNOPSIS
  903.     EI_GetPrefsColor(depth, tag)
  904.                      D0     D1
  905.  
  906.     LONG EI_GetPrefsColor(WORD, ULONG)
  907.  
  908.    FUNCTION
  909.  
  910.    INPUTS
  911.     depth        -
  912.     tag          -
  913.  
  914.    RESULT
  915.  
  916.    SEE ALSO
  917.  
  918.  
  919. egsintui.library/EI_GetWinColor               egsintui.library/EI_GetWinColor
  920.  
  921.    NAME
  922.     EI_GetWinColor -- get one of the windows color
  923.  
  924.    SYNOPSIS
  925.     EI_GetWinColor(colors, tag)
  926.                    A0      D0
  927.  
  928.     ULONG EI_GetWinColor(EI_ColorTablePtr, ULONG)
  929.  
  930.    FUNCTION
  931.     Returns one of a screens/windows colors.
  932.  
  933.    INPUTS
  934.     colors  : The color table, of a screen or a window
  935.     tag     : One of the colortags from egsintui.h
  936.  
  937.    RESULT
  938.     color   : The selected color
  939.  
  940.    SEE ALSO
  941.  
  942.  
  943. egsintui.library/EI_Interpret                   egsintui.library/EI_Interpret
  944.  
  945.    NAME
  946.     EI_Interpret -- interpret IntuiGfx programm
  947.  
  948.    SYNOPSIS
  949.     EI_Interpret(rast, colors, toff, prog, x, y)
  950.                  A0    A1      A2    A3    D0 D1
  951.  
  952.     void EI_Interpret(EG_RastPortPtr, IG_WinColorsPtr, IG_IntuiGfxPtr, IG_IntuiGfxPtr, WORD, WORD)
  953.  
  954.    FUNCTION
  955.     Interperts an intuiGfx programm (see also intuigfx.doc)
  956.  
  957.    INPUTS
  958.     rast   : rastport to draw in
  959.     colors : wincolors from window
  960.     toff   : pointer to sufficient stack space (stacktop)
  961.     prog   : pointer to first command
  962.     x, y   : starting location
  963.  
  964.    RESULT
  965.  
  966.    SEE ALSO
  967.  
  968.  
  969. egsintui.library/EI_Interpret1Param       egsintui.library/EI_Interpret1Param
  970.  
  971.    NAME
  972.     EI_Interpret1Param -- interpret IntuiGfx programm
  973.  
  974.    SYNOPSIS
  975.     EI_Interpret1Param(rast, colors, prog, x, y, para1)
  976.                        A0    A1      A2    D0 D1 D2
  977.  
  978.     void EI_Interpret1Param(EG_RastPortPtr, IG_WinColorsPtr, IG_IntuiGfxPtr, WORD, WORD, LONG)
  979.  
  980.    FUNCTION
  981.     Interpret IntuiGfx programm with one parameter (see also
  982.     intuigfx.doc), allocates own stack with 256 entries.
  983.  
  984.    INPUTS
  985.     rast   : rastport to draw in
  986.     colors : wincolors from window
  987.     prog   : pointer to first command
  988.     x, y   : starting location
  989.     para1  : parameter
  990.  
  991.    RESULT
  992.  
  993.    SEE ALSO
  994.  
  995.  
  996. egsintui.library/EI_Interpret2Param       egsintui.library/EI_Interpret2Param
  997.  
  998.    NAME
  999.     EI_Interpret2Param -- interpret IntuiGfx programm
  1000.  
  1001.    SYNOPSIS
  1002.     EI_Interpret2Param(rast, colors, prog, x, y, para1, para2)
  1003.                        A0    A1      A2    D0 D1 D2     D3
  1004.  
  1005.     void EI_Interpret2Param(EG_RastPortPtr, IG_WinColorsPtr, IG_IntuiGfxPtr, WORD, WORD, LONG, LONG)
  1006.  
  1007.    FUNCTION
  1008.     Interpret IntuiGfx programm with two parameters (see also
  1009.     intuigfx.doc), allocates own stack with 256 entries.
  1010.  
  1011.    INPUTS
  1012.     rast   : rastport to draw in
  1013.     colors : wincolors from window
  1014.     prog   : pointer to first command
  1015.     x, y   : starting location
  1016.     para1  : parameter 1
  1017.     para2  : parameter 2
  1018.  
  1019.    RESULT
  1020.  
  1021.    SEE ALSO
  1022.  
  1023.  
  1024. egsintui.library/EI_InterpretStacked     egsintui.library/EI_InterpretStacked
  1025.  
  1026.    NAME
  1027.     EI_InterpretStacked -- interpret IntuiGfx programm
  1028.  
  1029.    SYNOPSIS
  1030.     EI_InterpretStacked(rast, colors, prog, x, y)
  1031.                         A0    A1      A2    D0 D1
  1032.  
  1033.     void EI_InterpretStacked(EG_RastPortPtr, IG_WinColorsPtr, IG_IntuiGfxPtr, WORD, WORD)
  1034.  
  1035.    FUNCTION
  1036.     Interpret IntuiGfx programm without parameters (see also
  1037.     intuigfx.doc), allocates own stack with 256 entries.
  1038.  
  1039.    INPUTS
  1040.     rast   : rastport to draw in
  1041.     colors : wincolors from window
  1042.     prog   : pointer to first command
  1043.     x, y   : starting location
  1044.  
  1045.    RESULT
  1046.  
  1047.    SEE ALSO
  1048.  
  1049.  
  1050. egsintui.library/EI_LockIntuition           egsintui.library/EI_LockIntuition
  1051.  
  1052.    NAME
  1053.     EI_LockIntuition -- lock intuition
  1054.  
  1055.    SYNOPSIS
  1056.     EI_LockIntuition()
  1057.  
  1058.  
  1059.     void EI_LockIntuition(void)
  1060.  
  1061.    FUNCTION
  1062.     Locks intuition. No user or window actions can take place if
  1063.     intuition is locked. This call must be paired by EI_UnlockIntuition.
  1064.  
  1065.    INPUTS
  1066.  
  1067.    RESULT
  1068.  
  1069.    SEE ALSO
  1070.  
  1071.  
  1072. egsintui.library/EI_MigrateWindow           egsintui.library/EI_MigrateWindow
  1073.  
  1074.    NAME
  1075.     EI_MigrateWindow --
  1076.  
  1077.    SYNOPSIS
  1078.     EI_MigrateWindow(win, scr, x, y)
  1079.                      A0   A1   D0 D1
  1080.  
  1081.     void EI_MigrateWindow(EI_WindowPtr, EI_ScreenPtr, WORD, WORD)
  1082.  
  1083.    FUNCTION
  1084.  
  1085.    INPUTS
  1086.     win          -
  1087.     scr          -
  1088.     x            -
  1089.     y            -
  1090.  
  1091.    RESULT
  1092.  
  1093.    SEE ALSO
  1094.  
  1095.  
  1096. egsintui.library/EI_ModifyIDCMP               egsintui.library/EI_ModifyIDCMP
  1097.  
  1098.    NAME
  1099.     EI_ModifyIDCMP -- modifies windows idcmp
  1100.  
  1101.    SYNOPSIS
  1102.     EI_ModifyIDCMP(win, flags)
  1103.                    A0   D0
  1104.  
  1105.     void EI_ModifyIDCMP(EI_WindowPtr, ULONG)
  1106.  
  1107.    FUNCTION
  1108.     Wodifies a windows idcmp flags. Opens or closes the port if
  1109.     necessary. If the window has its own port (not created by intui..),
  1110.     this port will be untouched.
  1111.  
  1112.    INPUTS
  1113.     win   : pointer to window
  1114.     flags : flagset of EI_EIDCMPFlags
  1115.  
  1116.    RESULT
  1117.  
  1118.    SEE ALSO
  1119.  
  1120.  
  1121. egsintui.library/EI_MoveWindow                 egsintui.library/EI_MoveWindow
  1122.  
  1123.    NAME
  1124.     EI_MoveWindow -- moves a window
  1125.  
  1126.    SYNOPSIS
  1127.     EI_MoveWindow(win, dx, dy)
  1128.                   A0   D0  D1
  1129.  
  1130.     void EI_MoveWindow(EI_WindowPtr, WORD, WORD)
  1131.  
  1132.    FUNCTION
  1133.     Moves a window by dx, dy. The window may be moved out of the screen.
  1134.     This function may cause refresh events.
  1135.  
  1136.    INPUTS
  1137.     win          -
  1138.     dx           -
  1139.     dy           -
  1140.  
  1141.    RESULT
  1142.  
  1143.    SEE ALSO
  1144.  
  1145.  
  1146. egsintui.library/EI_ObtainColor               egsintui.library/EI_ObtainColor
  1147.  
  1148.    NAME
  1149.     EI_ObtainColor -- obtain one of a screens color
  1150.  
  1151.    SYNOPSIS
  1152.     EI_ObtainColor(scr, r, g, b)
  1153.                    A0   D0 D1 D2
  1154.  
  1155.     ULONG EI_ObtainColor(EI_ScreenPtr, UBYTE, UBYTE, UBYTE)
  1156.  
  1157.    FUNCTION
  1158.     Locks a colorregister of the screen for usage with red/green/blue or
  1159.     returns the 24 bit color value associated to red/green/blue. You
  1160.     have to release this color, if you do not need it anymore. But
  1161.     notice, that the color register may be reused at once, so make sure
  1162.     that nothing is rendered in this color before you release it. If no
  1163.     color register is free and no used one is close enough, this function
  1164.     will return the 24 color value itself. The egsgfx and egsblit library
  1165.     will use this value and approximate it by dithering.
  1166.  
  1167.    INPUTS
  1168.     scr             : The screen on which the color is to be used
  1169.     red,green,blue  : The color values that build the color
  1170.  
  1171.    RESULT
  1172.     color           : A color value that can be used for egsgfx and egsblit
  1173.  
  1174.    SEE ALSO
  1175.  
  1176.  
  1177. egsintui.library/EI_OffGList                     egsintui.library/EI_OffGList
  1178.  
  1179.    NAME
  1180.     EI_OffGList -- deactivate several gadgets
  1181.  
  1182.    SYNOPSIS
  1183.     EI_OffGList(win, gad, num)
  1184.                 A0   A1   D0
  1185.  
  1186.     void EI_OffGList(EI_WindowPtr, EI_GadgetPtr, WORD)
  1187.  
  1188.    FUNCTION
  1189.     Deaactivates a list of gadgets and draws their passive rendering
  1190.     (see structures for more information). The gadgets can not be reached
  1191.     by the user if they are deactivated. The gadgets can be reactivated
  1192.     using EI_OnGList. If the list contains a master gadget, all of its
  1193.     son gadgets are also deactivated.
  1194.  
  1195.    INPUTS
  1196.     win    : pointer to window
  1197.     gad    : pointer to first gadget in list
  1198.     num    : number of gadgets in list
  1199.  
  1200.    RESULT
  1201.  
  1202.    SEE ALSO
  1203.  
  1204.  
  1205. egsintui.library/EI_OffGadget                   egsintui.library/EI_OffGadget
  1206.  
  1207.    NAME
  1208.     EI_OffGadget -- deactivate gadget
  1209.  
  1210.    SYNOPSIS
  1211.     EI_OffGadget(win, gad)
  1212.                  A0   A1
  1213.  
  1214.     void EI_OffGadget(EI_WindowPtr, EI_GadgetPtr)
  1215.  
  1216.    FUNCTION
  1217.     Deaactivates a gadget and draws its passive rendering (see
  1218.     structures for more information). The gadget can not be reached by
  1219.     the user if it is deactivated. The gadget can be reactivated using
  1220.     EI_OnGadget. If the gadget is a master gadget, all of its son gadgets
  1221.     are also deactivated.
  1222.  
  1223.    INPUTS
  1224.     win          -
  1225.     gad          -
  1226.  
  1227.    RESULT
  1228.  
  1229.    SEE ALSO
  1230.  
  1231.  
  1232. egsintui.library/EI_OffMenuItem               egsintui.library/EI_OffMenuItem
  1233.  
  1234.    NAME
  1235.     EI_OffMenuItem -- deactivates a menu item
  1236.  
  1237.    SYNOPSIS
  1238.     EI_OffMenuItem(menu, item)
  1239.                    A0    A1
  1240.  
  1241.     void EI_OffMenuItem(EI_MenuPtr, EI_MenuItemPtr)
  1242.  
  1243.    FUNCTION
  1244.     Deactivates a menu item, and makes it unselectable.
  1245.  
  1246.     INPUT menu     : The menu that contains the item item     : The item
  1247.     itself
  1248.  
  1249.    INPUTS
  1250.     menu         -
  1251.     item         -
  1252.  
  1253.    RESULT
  1254.  
  1255.    SEE ALSO
  1256.  
  1257.  
  1258. egsintui.library/EI_OnGList                       egsintui.library/EI_OnGList
  1259.  
  1260.    NAME
  1261.     EI_OnGList -- activate several gadgets
  1262.  
  1263.    SYNOPSIS
  1264.     EI_OnGList(win, gad, num)
  1265.                A0   A1   D0
  1266.  
  1267.     void EI_OnGList(EI_WindowPtr, EI_GadgetPtr, WORD)
  1268.  
  1269.    FUNCTION
  1270.     Activates a list of gadgets, and draws their active rendering. The
  1271.     gadgets can now be reached by the user. If there is a master gadget
  1272.     in the list then all son gadgets are activated too.
  1273.  
  1274.    INPUTS
  1275.     win    : pointer to window
  1276.     gad    : pointer to first gadget in list
  1277.     num    : number of gadgets in list
  1278.  
  1279.    RESULT
  1280.  
  1281.    SEE ALSO
  1282.  
  1283.  
  1284. egsintui.library/EI_OnGadget                     egsintui.library/EI_OnGadget
  1285.  
  1286.    NAME
  1287.     EI_OnGadget -- activate a gadget
  1288.  
  1289.    SYNOPSIS
  1290.     EI_OnGadget(win, gad)
  1291.                 A0   A1
  1292.  
  1293.     void EI_OnGadget(EI_WindowPtr, EI_GadgetPtr)
  1294.  
  1295.    FUNCTION
  1296.     Activates a gadget, and draws its active rendering. The gadget can
  1297.     now be reached by the user. If it is a master gadget then all son
  1298.     gadgets are activated too.
  1299.  
  1300.    INPUTS
  1301.     win          -
  1302.     gad          -
  1303.  
  1304.    RESULT
  1305.  
  1306.    SEE ALSO
  1307.  
  1308.  
  1309. egsintui.library/EI_OnMenuItem                 egsintui.library/EI_OnMenuItem
  1310.  
  1311.    NAME
  1312.     EI_OnMenuItem -- activates a menu item
  1313.  
  1314.    SYNOPSIS
  1315.     EI_OnMenuItem(menu, item)
  1316.                   A0    A1
  1317.  
  1318.     void EI_OnMenuItem(EI_MenuPtr, EI_MenuItemPtr)
  1319.  
  1320.    FUNCTION
  1321.     Activates a menu item, and makes it selectable again.
  1322.  
  1323.     INPUT menu     : The menu that contains the item item     : The item
  1324.     itself
  1325.  
  1326.    INPUTS
  1327.     menu         -
  1328.     item         -
  1329.  
  1330.    RESULT
  1331.  
  1332.    SEE ALSO
  1333.  
  1334.  
  1335. egsintui.library/EI_OpenScreen                 egsintui.library/EI_OpenScreen
  1336.  
  1337.    NAME
  1338.     EI_OpenScreen -- opens a screen
  1339.  
  1340.    SYNOPSIS
  1341.     EI_OpenScreen(newScreen)
  1342.                   A0
  1343.  
  1344.     EI_ScreenPtr EI_OpenScreen(struct EI_NewScreen *)
  1345.  
  1346.    FUNCTION
  1347.     Opens a screen that is able to contain windows. Initialises all
  1348.     needed structures like E_EScreen, EL_LayerInfo or EG_RastPort. This
  1349.     screen must be closed using EI_CloseScreen.
  1350.  
  1351.    INPUTS
  1352.     newScreen   : filled EI_NewScreen structure, containing all informations
  1353.         needed to open the screen
  1354.  
  1355.    RESULT
  1356.     a fully initialized screen pointer, or NULL if failed.
  1357.  
  1358.    SEE ALSO
  1359.  
  1360.  
  1361. egsintui.library/EI_OpenWindow                 egsintui.library/EI_OpenWindow
  1362.  
  1363.    NAME
  1364.     EI_OpenWindow -- open a window
  1365.  
  1366.    SYNOPSIS
  1367.     EI_OpenWindow(win)
  1368.                   A0
  1369.  
  1370.     EI_WindowPtr EI_OpenWindow(struct EI_NewWindow *)
  1371.  
  1372.    FUNCTION
  1373.     Opens a window on an EI_Screen, or the default screen, if none
  1374.     specified. If this is the first window on the default screen, also
  1375.     opens the default screen. This window must be closed using
  1376.     EI_CloseWindow.
  1377.  
  1378.    INPUTS
  1379.     new       : filled EI_NewWindow structure, containing all informations
  1380.           needed to open a window
  1381.  
  1382.    RESULT
  1383.     a handle to an open window, or NULL if failed.
  1384.  
  1385.    SEE ALSO
  1386.  
  1387.  
  1388. egsintui.library/EI_PutMenuHome               egsintui.library/EI_PutMenuHome
  1389.  
  1390.    NAME
  1391.     EI_PutMenuHome -- put menu back in strip
  1392.  
  1393.    SYNOPSIS
  1394.     EI_PutMenuHome(menu)
  1395.                    A0
  1396.  
  1397.     void EI_PutMenuHome(EI_MenuPtr)
  1398.  
  1399.    FUNCTION
  1400.     Puts a menu, which has been extracted from the menu strip back to
  1401.     the strip.
  1402.  
  1403.    INPUTS
  1404.     menu         -
  1405.  
  1406.    RESULT
  1407.  
  1408.    SEE ALSO
  1409.  
  1410.  
  1411. egsintui.library/EI_PutMenuOut                 egsintui.library/EI_PutMenuOut
  1412.  
  1413.    NAME
  1414.     EI_PutMenuOut -- extract menu from strip
  1415.  
  1416.    SYNOPSIS
  1417.     EI_PutMenuOut(menu, win, x, y)
  1418.                   A0    A1   D0 D1
  1419.  
  1420.     void EI_PutMenuOut(EI_MenuPtr, EI_WindowPtr, WORD, WORD)
  1421.  
  1422.    FUNCTION
  1423.     Extract a menu from its menu strip. The menu then stays open, and
  1424.     can be moved around the screen as a layer. The menu can be put back
  1425.     using EI_PutMenuHome. The same can be achieved by the user, using a
  1426.     special menu item (see structures for more information)
  1427.  
  1428.    INPUTS
  1429.     menu    : pointer to menu to extract
  1430.     win     : window to which the menu belongs
  1431.     x, y    : upper left edge, where the menu first appears
  1432.  
  1433.    RESULT
  1434.  
  1435.    SEE ALSO
  1436.  
  1437.  
  1438. egsintui.library/EI_RedrawGadgetList     egsintui.library/EI_RedrawGadgetList
  1439.  
  1440.    NAME
  1441.     EI_RedrawGadgetList --
  1442.  
  1443.    SYNOPSIS
  1444.     EI_RedrawGadgetList(win, border, inside)
  1445.                         A0   D0      D1
  1446.  
  1447.     void EI_RedrawGadgetList(EI_WindowPtr, ULONG, ULONG)
  1448.  
  1449.    FUNCTION
  1450.  
  1451.    INPUTS
  1452.     win          -
  1453.     border       -
  1454.     inside       -
  1455.  
  1456.    RESULT
  1457.  
  1458.    SEE ALSO
  1459.  
  1460.  
  1461. egsintui.library/EI_RefreshGList             egsintui.library/EI_RefreshGList
  1462.  
  1463.    NAME
  1464.     EI_RefreshGList -- refresh several gadgets
  1465.  
  1466.    SYNOPSIS
  1467.     EI_RefreshGList(win, gad, num)
  1468.                     A0   A1   D0
  1469.  
  1470.     void EI_RefreshGList(EI_WindowPtr, EI_GadgetPtr, WORD)
  1471.  
  1472.    FUNCTION
  1473.     Refreshes a list of gadgets, by recalculating all asociated elements
  1474.     (propgadget) and redraws them. This function has to be called if
  1475.     gadget are modified by a programm, to show their new state. If a
  1476.     gadget in the list is a master gadget then all son gadgets are
  1477.     refreshed too.
  1478.  
  1479.    INPUTS
  1480.     win    : pointer to window
  1481.     gad    : pointer to first gadget in list
  1482.     num    : number of gadgets in list
  1483.  
  1484.    RESULT
  1485.  
  1486.    SEE ALSO
  1487.  
  1488.  
  1489. egsintui.library/EI_RefreshGadget           egsintui.library/EI_RefreshGadget
  1490.  
  1491.    NAME
  1492.     EI_RefreshGadget -- refresh a gadget
  1493.  
  1494.    SYNOPSIS
  1495.     EI_RefreshGadget(win, gad)
  1496.                      A0   A1
  1497.  
  1498.     void EI_RefreshGadget(EI_WindowPtr, EI_GadgetPtr)
  1499.  
  1500.    FUNCTION
  1501.     Refreshes a gadget, by recalculating all asociated elements
  1502.     (propgadget) and redraws it. This function has to be called if the
  1503.     gadget is modified by a programm, to show its new state. If the
  1504.     gadget is a master gadget then all son gadgets are refreshed too.
  1505.     Refresh caused by obscured gadget parts is carried out by EGSIntui
  1506.     automagically.
  1507.  
  1508.    INPUTS
  1509.     win          -
  1510.     gad          -
  1511.  
  1512.    RESULT
  1513.  
  1514.    SEE ALSO
  1515.  
  1516.  
  1517. egsintui.library/EI_RefreshScreen           egsintui.library/EI_RefreshScreen
  1518.  
  1519.    NAME
  1520.     EI_RefreshScreen --
  1521.  
  1522.    SYNOPSIS
  1523.     EI_RefreshScreen(scr)
  1524.                      A0
  1525.  
  1526.     void EI_RefreshScreen(EI_ScreenPtr)
  1527.  
  1528.    FUNCTION
  1529.  
  1530.    INPUTS
  1531.     scr          -
  1532.  
  1533.    RESULT
  1534.  
  1535.    SEE ALSO
  1536.  
  1537.  
  1538. egsintui.library/EI_RefreshWindow           egsintui.library/EI_RefreshWindow
  1539.  
  1540.    NAME
  1541.     EI_RefreshWindow --
  1542.  
  1543.    SYNOPSIS
  1544.     EI_RefreshWindow(win)
  1545.                      A0
  1546.  
  1547.     void EI_RefreshWindow(EI_WindowPtr)
  1548.  
  1549.    FUNCTION
  1550.  
  1551.    INPUTS
  1552.     win          -
  1553.  
  1554.    RESULT
  1555.  
  1556.    SEE ALSO
  1557.  
  1558.  
  1559. egsintui.library/EI_ReleaseColor             egsintui.library/EI_ReleaseColor
  1560.  
  1561.    NAME
  1562.     EI_ReleaseColor -- frees a color of a screen
  1563.  
  1564.    SYNOPSIS
  1565.     EI_ReleaseColor(scr, color)
  1566.                     A0   D0
  1567.  
  1568.     void EI_ReleaseColor(EI_ScreenPtr, ULONG)
  1569.  
  1570.    FUNCTION
  1571.     Returns a color register that was locked using "EI_ObtainColor" or
  1572.     "EI_CloneColor" back to the free pool. The color of this register
  1573.     may change at once, so make sure that there is no rendering in this
  1574.     color left. If the color is 24 bit value nothing is done.
  1575.  
  1576.    INPUTS
  1577.     scr          -
  1578.     color        -
  1579.  
  1580.    RESULT
  1581.  
  1582.    SEE ALSO
  1583.  
  1584.  
  1585. egsintui.library/EI_RemoveGList               egsintui.library/EI_RemoveGList
  1586.  
  1587.    NAME
  1588.     EI_RemoveGList -- remove several gadgets
  1589.  
  1590.    SYNOPSIS
  1591.     EI_RemoveGList(win, gad, num)
  1592.                    A0   A1   D0
  1593.  
  1594.     void EI_RemoveGList(EI_WindowPtr, EI_GadgetPtr, WORD)
  1595.  
  1596.    FUNCTION
  1597.     Removes a list of gadgets from a windows gadget list, and fills
  1598.     their former location with the windows background color. If a gadget
  1599.     in the list is a mastergadget, then all son gadgets are removed too.
  1600.  
  1601.    INPUTS
  1602.     win    : pointer to window
  1603.     gad    : pointer to first gadget in list
  1604.     num    : number of gadgets in list
  1605.  
  1606.    RESULT
  1607.  
  1608.    SEE ALSO
  1609.  
  1610.  
  1611. egsintui.library/EI_RemoveGadget             egsintui.library/EI_RemoveGadget
  1612.  
  1613.    NAME
  1614.     EI_RemoveGadget -- removes a gadget
  1615.  
  1616.    SYNOPSIS
  1617.     EI_RemoveGadget(win, gad)
  1618.                     A0   A1
  1619.  
  1620.     void EI_RemoveGadget(EI_WindowPtr, EI_GadgetPtr)
  1621.  
  1622.    FUNCTION
  1623.     Removes a gadget from a windows gadget list, and fills its former
  1624.     location with the windows background color. If the gadget is a master
  1625.     gadget, then all son gadgets are removed too.
  1626.  
  1627.    INPUTS
  1628.     win          -
  1629.     gad          -
  1630.  
  1631.    RESULT
  1632.  
  1633.    SEE ALSO
  1634.  
  1635.  
  1636. egsintui.library/EI_ReportMouse               egsintui.library/EI_ReportMouse
  1637.  
  1638.    NAME
  1639.     EI_ReportMouse -- determines if mouse moves shall be send
  1640.  
  1641.    SYNOPSIS
  1642.     EI_ReportMouse(win, flag)
  1643.                    A0   D0
  1644.  
  1645.     void EI_ReportMouse(EI_WindowPtr, BOOL)
  1646.  
  1647.    FUNCTION
  1648.     Determines wether mouse move messages shall be send to a window or
  1649.     not. If flag is true, then following mouse moves will be broadcasted
  1650.     to your window, else not. To receive mouse moves you also have to set
  1651.     EI_iMouseMove in your eidcmpflags.
  1652.  
  1653.    INPUTS
  1654.     win          -
  1655.     flag         -
  1656.  
  1657.    RESULT
  1658.  
  1659.    SEE ALSO
  1660.  
  1661.  
  1662. egsintui.library/EI_ScrollWindow             egsintui.library/EI_ScrollWindow
  1663.  
  1664.    NAME
  1665.     EI_ScrollWindow -- scroll a window
  1666.  
  1667.    SYNOPSIS
  1668.     EI_ScrollWindow(win, dx, dy)
  1669.                     A0   D0  D1
  1670.  
  1671.     void EI_ScrollWindow(EI_WindowPtr, WORD, WORD)
  1672.  
  1673.    FUNCTION
  1674.     Scrolls the interiour of a window by dx, dy. This function only
  1675.     works with GimmeZeroZero or borderless windows. This function also
  1676.     modifies the coordinates of the windows upper left corner.
  1677.  
  1678.    INPUTS
  1679.     win          -
  1680.     dx           -
  1681.     dy           -
  1682.  
  1683.    RESULT
  1684.  
  1685.    SEE ALSO
  1686.  
  1687.  
  1688. egsintui.library/EI_SetMenuStrip             egsintui.library/EI_SetMenuStrip
  1689.  
  1690.    NAME
  1691.     EI_SetMenuStrip -- sets new menu strip
  1692.  
  1693.    SYNOPSIS
  1694.     EI_SetMenuStrip(win, menu)
  1695.                     A0   A1
  1696.  
  1697.     void EI_SetMenuStrip(EI_WindowPtr, EI_MenuPtr)
  1698.  
  1699.    FUNCTION
  1700.     Sets a new menu strip for a window. EI_SetMenuStrip(win,NIL) clears
  1701.     the current menu strip. This function puts all extracted submenus
  1702.     back to the strip.
  1703.  
  1704.    INPUTS
  1705.     win          -
  1706.     menu         -
  1707.  
  1708.    RESULT
  1709.  
  1710.    SEE ALSO
  1711.  
  1712.  
  1713. egsintui.library/EI_SetMouseMoveIntervallegsintui.library/EI_SetMouseMoveIntervall
  1714.  
  1715.    NAME
  1716.     EI_SetMouseMoveIntervall --
  1717.  
  1718.    SYNOPSIS
  1719.     EI_SetMouseMoveIntervall(win, micros)
  1720.                              A0   D0
  1721.  
  1722.     void EI_SetMouseMoveIntervall(EI_WindowPtr, LONG)
  1723.  
  1724.    FUNCTION
  1725.  
  1726.    INPUTS
  1727.     win          -
  1728.     micros       -
  1729.  
  1730.    RESULT
  1731.  
  1732.    SEE ALSO
  1733.  
  1734.  
  1735. egsintui.library/EI_SetPointer                 egsintui.library/EI_SetPointer
  1736.  
  1737.    NAME
  1738.     EI_SetPointer -- sets a mouse pointer for a window
  1739.  
  1740.    SYNOPSIS
  1741.     EI_SetPointer(win, mouse)
  1742.                   A0   A1
  1743.  
  1744.     void EI_SetPointer(EI_WindowPtr, E_EMousePtr)
  1745.  
  1746.    FUNCTION
  1747.     Sets a custom mouse pointer for a window. If the window is active,
  1748.     the pointer will change immediately, otherwise it will change, when
  1749.     this window is activated.
  1750.  
  1751.    INPUTS
  1752.     win          -
  1753.     mouse        -
  1754.  
  1755.    RESULT
  1756.  
  1757.    SEE ALSO
  1758.  
  1759.  
  1760. egsintui.library/EI_SetWindowTitles       egsintui.library/EI_SetWindowTitles
  1761.  
  1762.    NAME
  1763.     EI_SetWindowTitles -- modify window/screen title
  1764.  
  1765.    SYNOPSIS
  1766.     EI_SetWindowTitles(win, wTitle, sTitle)
  1767.                        A0   A1      A2
  1768.  
  1769.     void EI_SetWindowTitles(EI_WindowPtr, char *, char *)
  1770.  
  1771.    FUNCTION
  1772.     Modifies a windows and/or screens title. Usage of -1 instead of a
  1773.     pointer to a text will not effect the current title, NULL clears the
  1774.     title.
  1775.  
  1776.    INPUTS
  1777.     win     : window pointer
  1778.     wTitle  : title to appear in the windows title
  1779.     sTitle  : title to appear in the screens title, when window is active
  1780.  
  1781.    RESULT
  1782.  
  1783.    SEE ALSO
  1784.  
  1785.  
  1786. egsintui.library/EI_SizeWindow                 egsintui.library/EI_SizeWindow
  1787.  
  1788.    NAME
  1789.     EI_SizeWindow -- change window size
  1790.  
  1791.    SYNOPSIS
  1792.     EI_SizeWindow(win, dx, dy)
  1793.                   A0   D0  D1
  1794.  
  1795.     void EI_SizeWindow(EI_WindowPtr, WORD, WORD)
  1796.  
  1797.    FUNCTION
  1798.     Changes a windows visible size. This function may cause a refresh
  1799.     message to be broadcasted.
  1800.  
  1801.    INPUTS
  1802.     win          -
  1803.     dx           -
  1804.     dy           -
  1805.  
  1806.    RESULT
  1807.  
  1808.    SEE ALSO
  1809.  
  1810.  
  1811. egsintui.library/EI_SleepWindow               egsintui.library/EI_SleepWindow
  1812.  
  1813.    NAME
  1814.     EI_SleepWindow -- put a window to sleep
  1815.  
  1816.    SYNOPSIS
  1817.     EI_SleepWindow(win)
  1818.                    A0
  1819.  
  1820.     void EI_SleepWindow(EI_WindowPtr)
  1821.  
  1822.    FUNCTION
  1823.     Puts a window to sleep. A sleeping window gets no input events and
  1824.     can not be resized using the sizing gadget. The only message that is
  1825.     passed is an eventuall refresh message. This function may be handy
  1826.     for modal requests. The window can be awakened again using
  1827.     "WakeWindow".
  1828.  
  1829.    INPUTS
  1830.     win          -
  1831.  
  1832.    RESULT
  1833.  
  1834.    SEE ALSO
  1835.  
  1836.  
  1837. egsintui.library/EI_SysRequest                 egsintui.library/EI_SysRequest
  1838.  
  1839.    NAME
  1840.     EI_SysRequest -- make system request
  1841.  
  1842.    SYNOPSIS
  1843.     EI_SysRequest(win, title, bodyTxt, gadgTxt)
  1844.                   A0   A1     A2       A3
  1845.  
  1846.     WORD EI_SysRequest(EI_WindowPtr, char *, char *, char *)
  1847.  
  1848.    FUNCTION
  1849.     Creates and opens a system request, on a windows screen, or the
  1850.     default screen. Then it waits for the user to answer the request, by
  1851.     clicking on one of the buttons. The request text may have several
  1852.     lines and several gadgets by seperating them through a "|".
  1853.  
  1854.    INPUTS
  1855.     win     : window on which screen the requester shall appear, 
  1856.               or NULL for default screen
  1857.     title   : requesters title
  1858.     bodyTxt : text in the requesters body, lines seperated by "|"
  1859.     gadgTxt : text of the gadgets, seperated by "|"
  1860.  
  1861.    RESULT
  1862.     the number of the gadget, that was pressed
  1863.  
  1864.    EXAMPLE
  1865.     res = EI_SysRequest(mywin, "Request",
  1866.               "Not enough memory|to proceed",
  1867.               "RETRY|IGNORE|CANCEL");
  1868.  
  1869.    SEE ALSO
  1870.  
  1871.  
  1872. egsintui.library/EI_ToggleMenuItem         egsintui.library/EI_ToggleMenuItem
  1873.  
  1874.    NAME
  1875.     EI_ToggleMenuItem -- toggles the state of a menu item
  1876.  
  1877.    SYNOPSIS
  1878.     EI_ToggleMenuItem(menu, item)
  1879.                       A0    A1
  1880.  
  1881.     void EI_ToggleMenuItem(EI_MenuPtr, EI_MenuItemPtr)
  1882.  
  1883.    FUNCTION
  1884.     Toggles the state (checkmark) of a toggle menu item. If the menu
  1885.     resides on the screen, the change will be noticeable at once.
  1886.  
  1887.    INPUTS
  1888.     menu         -
  1889.     item         -
  1890.  
  1891.    RESULT
  1892.  
  1893.    SEE ALSO
  1894.  
  1895.  
  1896. egsintui.library/EI_UnlockIntuition       egsintui.library/EI_UnlockIntuition
  1897.  
  1898.    NAME
  1899.     EI_UnlockIntuition -- unlocks intuition
  1900.  
  1901.    SYNOPSIS
  1902.     EI_UnlockIntuition()
  1903.  
  1904.  
  1905.     void EI_UnlockIntuition(void)
  1906.  
  1907.    FUNCTION
  1908.     Partner from EI_LockIntuition
  1909.  
  1910.    INPUTS
  1911.  
  1912.    RESULT
  1913.  
  1914.    SEE ALSO
  1915.  
  1916.  
  1917. egsintui.library/EI_WakeWindow                 egsintui.library/EI_WakeWindow
  1918.  
  1919.    NAME
  1920.     EI_WakeWindow -- return window from sleeping state
  1921.  
  1922.    SYNOPSIS
  1923.     EI_WakeWindow(win)
  1924.                   A0
  1925.  
  1926.     void EI_WakeWindow(EI_WindowPtr)
  1927.  
  1928.    FUNCTION
  1929.     Returns a window back from the sleeping state to active duty.
  1930.  
  1931.    INPUTS
  1932.     win          -
  1933.  
  1934.    RESULT
  1935.  
  1936.    SEE ALSO
  1937.  
  1938.  
  1939. egsintui.library/EI_WindowBorder             egsintui.library/EI_WindowBorder
  1940.  
  1941.    NAME
  1942.     EI_WindowBorder -- modify maximum size of window
  1943.  
  1944.    SYNOPSIS
  1945.     EI_WindowBorder(win, dx, dy)
  1946.                     A0   D0  D1
  1947.  
  1948.     void EI_WindowBorder(EI_WindowPtr, WORD, WORD)
  1949.  
  1950.    FUNCTION
  1951.     Modifies the maximum size of a window by dx, dy.
  1952.  
  1953.    INPUTS
  1954.     win          -
  1955.     dx           -
  1956.     dy           -
  1957.  
  1958.    RESULT
  1959.  
  1960.    SEE ALSO
  1961.  
  1962.  
  1963. egsintui.library/EI_WindowToBack             egsintui.library/EI_WindowToBack
  1964.  
  1965.    NAME
  1966.     EI_WindowToBack -- move window back
  1967.  
  1968.    SYNOPSIS
  1969.     EI_WindowToBack(win)
  1970.                     A0
  1971.  
  1972.     void EI_WindowToBack(EI_WindowPtr)
  1973.  
  1974.    FUNCTION
  1975.     Moves a window behind all others on the screen, this function may
  1976.     cause refresh messages.
  1977.  
  1978.    INPUTS
  1979.     win          -
  1980.  
  1981.    RESULT
  1982.  
  1983.    SEE ALSO
  1984.  
  1985.  
  1986. egsintui.library/EI_WindowToFront           egsintui.library/EI_WindowToFront
  1987.  
  1988.    NAME
  1989.     EI_WindowToFront -- move window to front
  1990.  
  1991.    SYNOPSIS
  1992.     EI_WindowToFront(win)
  1993.                      A0
  1994.  
  1995.     void EI_WindowToFront(EI_WindowPtr)
  1996.  
  1997.    FUNCTION
  1998.     Moves a window in front of all other windows on a screen. This
  1999.     function may cause refresh messages.
  2000.  
  2001.    INPUTS
  2002.     win          -
  2003.  
  2004.    RESULT
  2005.  
  2006.    SEE ALSO
  2007.  
  2008.  
  2009.